2.1. Overview of the protocol

The protocol is an HTTP based RESTfull protocol using a limited set of methods. Each request may be followed by a response containing status information. The following methods are specified in the protocol description, PUT, POST, GET, DELETE. To avoid various issues with certain methods being blocked clients may use the X-HTTP-Method-Override: header to specify the intended operation. Servers SHOULD behave as if the named method was used.

POST /user/fred/calendar/ HTTP/1.1
...
X-HTTP-Method-Override: PUT
Properties

A service or resource will have a number of properties which describe the current state of that service or resource. These properties are accessed through a GET on the target resource or service with an ACCEPT header specifying application/xrd+xml. See Clause 2.1.3.6.

The following operations are defined by this specification:

  • Retrieval and update of service and resource properties

  • Creation of a calendar object

  • Retrieval of a calendar object

  • Update of a calendar object

  • Deletion of a calendar object

  • Query

  • Free-busy query